AWS Lambdaのログまわりに関することまとめ

T君

2016.09.16

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

最近、AWS Lambdaの勉強をしているのですがログまわりの機能が非常に便利だと感じました。私がAWS Lambdaのログ周りで調査した内容をまとめます。 Lambda使いたいけどCloudWatchあまり使ったことない方にぜひ読んでもらいたいです。言語は私はPythonとNode.jsを使えないのでJavaで試しています。

ロギングライブラリに関して

まずはロギングライブラリに関してです。 Javaに関する話になっていしまいますが、LambdaLoggerかlog4jを利用することでCloudWatchログに書き込むことが可能です。CloudWatchであれば過去ログの検索が簡単できたり、特定の文字列を含むログが出力された場合に通知することができるためかなり便利です。バックアップを自分で作成する必要もありません。

CloudWatchに書き込んだログを確認する

まずはLambdaLoggerを使ったログ出力のサンプルを作って試してみます。以下のLambda Functionを実行してみましょう。

package s3sample;

import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import com.amazonaws.services.lambda.runtime.events.S3Event;

public class SampleLambdaFunction implements RequestHandler<S3Event, Object> {
    @Override
    public Object handleRequest(S3Event input, Context context) {
        context.getLogger().log("Input: " + input);

        // TODO: implement your handler
        return null;
    }
}

Lambdaのロールに以下のポリシーを適用すると、CloudWatchにログ出力できるようになります。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents"
      ],
      "Resource": [
        "arn:aws:logs:*:*:*"
      ]
    }
  ]
}

実行したらログが出力されているかを確認します。Management ConsoleのCloudWatchの画面で左のメニューにあるログを選択します。

実行したLambda Functionと同じ名前のロググループがあるのでクリックします。次にログストリームの一覧が表示されますが、時間が一番新しいログストリームを選択してください。以下のように出力したログが表示されていると思います(２行目)。時間とキーワードで検索できます。キーワードはスペースで区切って複数指定できます。

log4jの導入手順

log4jはログレベル(DEBUG、INFO、WARN、ERROR、FATAL)を分けやすいのとlog4j.propertiesで自由にフォーマットを変えられるのでお勧めです。クラス名やソースコードの行数なども出力できます。CloudWatchログで検索する際にログレベルやクラス名を検索できますので便利ではないかと思います。

以下は2行目がlog4jで3行目をLambdaLoggerで出力しています。ログにクラス名と行数が表示されているのが分かります。

LambdaからLog4jを使ってCloudWatchログに出力するためには、log4のjarファイルとLambdaAppenderクラスを含んだjarファイルをダウンロードしクラスパスを通します。次に設定ファイルであるlog4j.propertiesを作成し、クラスパスが通っている場所に置いておきます。以下はLog4jでログ出力するサンプルソースになります。

Apache log4j 1.2 - Maven Repository: com.amazonaws » aws-lambda-java-log4j » 1.0.0

import org.apache.log4j.Logger;

import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;
import com.amazonaws.services.lambda.runtime.events.S3Event;

public class LambdaLogSample implements RequestHandler<S3Event, Object> {

    static final Logger logger = Logger.getLogger(LambdaLogSample.class);

    @Override
    public Object handleRequest(S3Event input, Context context) {
        logger.debug("log4j logger");
        return null;
    }
}

以下はlog4j.propertiesのサンプルになります。

log = .
log4j.rootLogger = DEBUG, LAMBDA

#Define the LAMBDA appender
log4j.appender.LAMBDA=com.amazonaws.services.lambda.runtime.log4j.LambdaAppender
log4j.appender.LAMBDA.layout=org.apache.log4j.PatternLayout
log4j.appender.LAMBDA.layout.conversionPattern=%d{yyyy-MM-dd HH:mm:ss} <%X{AWSRequestId}> %-5p %c{1}:%L - %m%n

以下のドキュメントを参考にしています。ロギング(Java) - AWS Lambda